home *** CD-ROM | disk | FTP | other *** search
/ Graphics Bonanza / Graphics Bonanza.iso / prog2 / frcsav / fsv_read.me < prev   
Text File  |  1991-08-17  |  10KB  |  265 lines
  1. FractalSave Screen Saver, Shareware version 1.0
  2. Copyright (c) 1991 by James H. Price
  3.  
  4.  
  5. This file tells you how to use the FractalSave screen saver program. To
  6. print a hard copy of the file, enter the following at a DOS prompt:
  7.  
  8.                     TYPE FSV_READ.ME > PRN
  9.  
  10. NOTE ON SHAREWARE:
  11.  
  12.     This is a shareware program, it is not free or public domain
  13. software.  You are encouraged to try it, without charge, for a period of
  14. 30 days.  If you continue to use it beyond the trial perios, you must
  15. register it. Please be honest about this.
  16.  
  17.     You're encouraged to distribute the program freely as long as it's
  18. not altered in any way, is distributed with this documentation, and if
  19. no charge is made for the program.    (Reasonable distribution fees to
  20. cover mailing or diskette costs are perfectly okay with me.)
  21.  
  22. INTRODUCTION:
  23.  
  24.     FractalSave is a TSR (terminate and stay resident) screen saver
  25. utility based on the popular FractalWeave shareware program.  When
  26. loaded in memory, FractalSave monitors the keyboard and mouse and "pops
  27. down" after a predetermined period of no activity. This prevents
  28. possible damage to your video monitor from "burn-in" due to having a
  29. fixed image written to your screen for prolonged periods.
  30.  
  31.     When it pops down, FractalSave displays a colorful, incredibly
  32. intricate, and constantly changing screen image.  An unlimited number of
  33. different images can be displayed, depending on the image file selected
  34. when the program is loaded.  Custom image files can be generated using
  35. the FractalWeave program (version 2.0 or later), another shareware
  36. product by the same author.
  37.  
  38. HARDWARE REQUIREMENTS:
  39.  
  40.     FractalSave requires an IBM PC or compatible computer.    Monitors of
  41. all types are supported.  Displaying FractalWeave image files requires
  42. an EGA or VGA color monitor with at least 256K of video memory.  On
  43. other types of monitors a text-based color or monochrome display is
  44. used.  The shareware version of FractalSave requires approximately 19k
  45. of memory when loaded in resident mode.  A hard disk is recommended, but
  46. not required.
  47.  
  48. WHAT'S ON THE DISK:
  49.  
  50.     The distribution disk or ZIP file should contain the files listed
  51. below.
  52.  
  53.     FSAVE.EXE            The screen saver program itself
  54.     DEMO00.WVE            Sample EGA image file
  55.     DEMO01.WVE          ditto
  56.     DEMO02.WVE          ditto
  57.     DEMO03.WVE          Sample VGA image file
  58.     FSV_READ.ME         This document
  59.  
  60.  
  61. INSTALLATION:
  62.  
  63.     As a convenience, copy FSAVE and the image (*.WVE) files to a
  64. directory on your PATH statement, otherwise you'll have to specify the
  65. full path when start the program.
  66.  
  67.     If you want to run the program from a floppy diskette, make a backup
  68. copy of the original files and place the backup disk in a safe place.
  69.  
  70.     NOTE TO FLOPPY DISK USERS:    When FractalSave pops down, it takes a
  71. snapshot of the current screen and saves it to a temporary file in the
  72. current directory.    When you press a key to return to your program,
  73. FractalSave reads the screen information from the disk, then deletes the
  74. file.  With a hard disk, the time it takes to save and restore the
  75. information from disk is negligible, particularly if you're using a disk
  76. cache. With a floppy disk, however, you might notice a small delay.
  77.  
  78.     FractalSave can be loaded automatically via your AUTOEXEC.BAT file.
  79. It can also be loaded into "high memory" if your have the appropriate
  80. hardware and software on your system.  See your DOS documentation for
  81. details.
  82.  
  83. RUNNING THE PROGRAM:
  84.  
  85.     There are a number of adjustable parameters which you can set from
  86. the command line to tailor the program to your own preferences. For a
  87. quick summary, type FSAVE /h at a DOS prompt.
  88.  
  89.     To load the program with the default parameters, just type FSAVE at
  90. a DOS prompt. The program will load itself into memory, and pop down
  91. after 5 minutes of no screen activity.
  92.  
  93.     To change the default settings, enter
  94.  
  95.         FSAVE [/option(value)] [/option(value)] ...
  96.  
  97.     Here the "/" tells the program a parameter is coming; "option"
  98. specifies which parameter is being adjusted, and "(value)" is the new
  99. value to set.  For example:
  100.  
  101.             FSAVE /d30 /fdemo01.wve
  102.  
  103. tells the program to set the default delay to 30 seconds, and to use the
  104. image file "demo01.wve".  The available parameters and their legal
  105. ranges are discussed below.
  106.  
  107.  
  108. COMMAND LINE PARAMETERS:
  109.  
  110.     Remember, you can get a synopsis of the available parameters, their
  111. legal and default values, and the command line syntax by typing FSAVE /h
  112. at the DOS prompt.
  113.  
  114.     Any number of parameters may be used, in any order. In case of a
  115. conflict, the value specified last will be used.  You may substitue a
  116. "-" in place of the "/" if you prefer.
  117.  
  118.     /u        This unloads the program from memory, or deactivates it if
  119.             it can't be safely unloaded.
  120.  
  121.     /n        This runs the program without keeping it in memory.  It's
  122.             useful when you're trying to adjust the program setting, or
  123.             simply want to view the FractalWeave images.
  124.  
  125.     /s        This adjusts the speed at which the "fractal ball" moves
  126.             around the screen.    Larger numbers gives slower speeds. The
  127.             default value is zero; you might want to increase it if you
  128.             have a fast machine, or prefer a leisurely display.
  129.  
  130.             The /s parameter also affects the text mode display; in this
  131.             case by slowing down the rate at which the colored boxes are
  132.             written to the screen.    The default value for text is 16.
  133.  
  134.     /t        This parameter affects the rate at which the palette is
  135.             changed in the graphics display.  It has no effect on the
  136.             text display.  Valid range is 0 - 60.  Zero specifies NO
  137.             change, while values from 1 - 60 specify a value in seconds.
  138.             The default value is 4.
  139.  
  140.     /f        Specifies which FractalWeave image file to load.  The
  141.             default is "demo00.wve".  If a path is not specified, the
  142.             program searches the PATH specified in your AUTOEXEC.BAT
  143.             file.  If the file is still not found, the program aborts
  144.             and returns the message "Couldn't open image file." Example:
  145.             " FSAVE /fc:\util\mywve.wve ".
  146.  
  147.             If you wish, you can use the /f switch with no filename to
  148.             force the text display.  You might wish to do this if you
  149.             use a program which writes to multiple text pages (see
  150.             below).
  151.  
  152.  
  153. QUIRKS and INCOMPATIBILITIES:
  154.  
  155.     1)    FractalSave will not pop down when a graphics program is running
  156.         in the foreground.
  157.  
  158.         This is by design.    Swapping a graphics screen to disk is very
  159.         slow; furthermore, (and primarily) a majority of graphics
  160.         programs (including Windows 3.0) exhibit the behavior discussed
  161.         in (3) below.
  162.  
  163.     2)    FractalSave should be run in text mode when used with a program
  164.         that writes to multiple text pages.
  165.  
  166.         FractalSave saves and restores only the foreground screen.    If
  167.         the foreground program writes to more than one page of text, the
  168.         information on subsequent pages is lost when FractalSave enters
  169.         a graphics mode.  In such a case, use the "/f" switch by itself
  170.         to force text mode.  (I don't know of any programs which
  171.         actually do this; if you do, please let me know.  It's an easy
  172.         modification for the next version.)
  173.  
  174.     3)    FractalSave (along with other TSRs) is incompatible with programs
  175.         which intercept the system timer or keyboard interrupts and
  176.         don't pass them along.
  177.  
  178.         In the first case, FractalWeave never finds out that it's time
  179.         to pop down, and doesn't.
  180.  
  181.         In the second case, FractalWeave pops down, and then waits
  182.         patiently for a keystroke which gets intercepted and never
  183.         arrives.  This gives the appearance of "hanging".
  184.  
  185.         To the credit of programmers everywhere, I don't know of any
  186.         text-based program which exhibits such pathological behavior.
  187.  
  188. ********
  189. LATE NEWS:    I spoke too soon. The new text editor included with DOS 5.0
  190. is not fully compatible with FractalSave, apparently due to keyboard
  191. conflicts similar to those just discussed.    Use them together with
  192. caution, if at all.
  193. ********
  194.  
  195. ABOUT THE PROGRAM:
  196.  
  197.     FractalSave is based on the very popular FractalWeave shareware
  198.     program by the same author.  Many users of FractalWeave requested a
  199.     screen saver version of that program.  FractalSave was written to
  200.     accomodate that demand.
  201.  
  202.     Version 2.0 of FractalWeave generates image files which are fully
  203.     compatible with FractalSave.  The demo image files included with
  204.     FractalSave only hint at the wide variety of images which can be
  205.     generated. FractalWeave gives you full control over the image.    You
  206.     can use it to create an unlimited number of custom images for use
  207.     with FractalSave.
  208.  
  209. *************************************************************************
  210.  
  211. REGISTERING FRACTALSAVE:
  212.  
  213.     FractalSave is a shareware program, not free or public domain
  214.     software.  A lot of time and effort went into developing it; if you
  215.     use it, you should register it.  Please be honest and fair about
  216.     this.
  217.  
  218.     To register FractalSave, send $15.00 to
  219.  
  220.                     James H. Price
  221.                     1253 E. Calaveras St
  222.                     Altadena, CA  91001
  223.  
  224. WHAT A DEAL:
  225.  
  226.     As an added inducement to register, I'll also send the latest
  227.     version of FractalWeave at no extra cost.
  228.  
  229. *************************************************************************
  230.  
  231. OBTAINING THE RETAIL VERSION:
  232.  
  233.     The shareware version of FractalSave is written primarily in C, with
  234.     video and graphics routines in assembly language.  It requires
  235.     approximately 19k of memory when resident.    The retail version of
  236.     FractalSave is written entirely in assembly language, and requires a
  237.     mere 4.5k of memory when resident.
  238.  
  239.     The retail version is being made available to registered owners of
  240.     FractalWeave and FractalSave for a modest $10.00 upgrade fee.  If
  241.     you haven't registered either of these products, you can take
  242.     advantage of the upgrade offer now.  Send $25.00 (instead of $15.00)
  243.     to the address above, and I'll send you the retail version of
  244.     FractalSave, and (what the heck) the latest version FractalWeave at
  245.     no extra cost.
  246.  
  247.  
  248. CONTACTING THE AUTHOR:
  249.  
  250.     If you have any questions or difficulties with the program, feel
  251.     free to contact me at the above address. I can also be reached via
  252.     CompuServe E-mail at 76264,3534.
  253.  
  254. FINE PRINT:
  255.  
  256.     This program is distributed as-is.  There is no warranty of any
  257.     kind.  By using the program, you agree to this.
  258.  
  259.  
  260.  
  261. I hope you enjoy the program.
  262.  
  263.  
  264. Jim Price
  265.